home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / install.z / install
Text File  |  1998-10-20  |  13KB  |  265 lines
  1.  
  2.  
  3.  
  4. IIIINNNNSSSSTTTTAAAALLLLLLLL((((1111))))                                                          IIIINNNNSSSSTTTTAAAALLLLLLLL((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      install - install files in directories
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////ssssbbbbiiiinnnn////iiiinnnnssssttttaaaallllllll _o_p_t_i_o_n_s _f_i_l_e ...
  13.  
  14. BBBBSSSSDDDD////GGGGNNNNUUUU SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.      ////ssssbbbbiiiinnnn////iiiinnnnssssttttaaaallllllll _o_p_t_i_o_n_s _f_i_l_e ... directory
  16.      ////ssssbbbbiiiinnnn////iiiinnnnssssttttaaaallllllll _o_p_t_i_o_n_s file1 file2
  17.      ////ssssbbbbiiiinnnn////iiiinnnnssssttttaaaallllllll _o_p_t_i_o_n_s -_d directories ...
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _I_n_s_t_a_l_l copies regular _f_i_l_e_s generated in a source tree into a target
  21.      directory.  It can also create directories, links and special files in a
  22.      target directory.  The target directory's pathname will be prefixed by
  23.      the value of the RRRROOOOOOOOTTTT environment variable.  _I_n_s_t_a_l_l is most commonly
  24.      invoked from makefiles (see _m_a_k_e(1)).
  25.  
  26.      If the RRRRAAAAWWWWIIIIDDDDBBBB environment variable is set, _i_n_s_t_a_l_l creates no files in
  27.      target directories; instead, it appends records describing the files that
  28.      it would have created to the installation database (IDB) named by
  29.      $$$$RRRRAAAAWWWWIIIIDDDDBBBB.  When generating an IDB, either _i_n_s_t_a_l_l must be invoked under a
  30.      directory named ssssrrrrcccc, or the SSSSRRRRCCCC environment variable must be set and must
  31.      name an ancestor of the current working directory.
  32.  
  33.      _I_n_s_t_a_l_l's options specify how to install, what type of file to create,
  34.      and where to install in the target tree.  Options are collected from the
  35.      IIIINNNNSSSSTTTTOOOOPPPPTTTTSSSS environment variable, then from the command line.  If
  36.      incompatible options are specified in IIIINNNNSSSSTTTTOOOOPPPPTTTTSSSS and the command line, the
  37.      command line options take precedence.  Note that single-letter options
  38.      cannot be concatenated after a hyphen.
  39.  
  40.      BSD/GNU compatibility (where the target file or directory is the last
  41.      argument) is supported in case none of the mandatory arguments (-f, -F,
  42.      or -dir) is provided. In this case the ----ssss option means strip.
  43.  
  44.      The options are:
  45.  
  46.      -m _m_o_d_e         Set the mode of created files to _m_o_d_e, interpreted as an
  47.                      octal number.  The default mode for regular files and
  48.                      directories is 755.  The default mode for devices and
  49.                      named pipes is 666.  This option is ignored if given with
  50.                      ----llllnnnn or ----llllnnnnssss.
  51.  
  52.      -u _o_w_n_e_r        Set the owner of created files to _o_w_n_e_r, which is
  53.                      interpreted first as a user name, then as a numeric user
  54.                      ID if it fails to match known user names.  If the
  55.                      superuser invokes _i_n_s_t_a_l_l, the default owner is rrrrooooooootttt.
  56.                      Otherwise the default owner is the effective user ID of
  57.                      the invoker.  This option is ignored if given with ----llllnnnn.
  58.                      If $$$$RRRRAAAAWWWWIIIIDDDDBBBB is set, and ----llllnnnnssss is used, it is effectively
  59.                      ignored, because _i_n_s_t(1m) does not support setting the
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIINNNNSSSSTTTTAAAALLLLLLLL((((1111))))                                                          IIIINNNNSSSSTTTTAAAALLLLLLLL((((1111))))
  71.  
  72.  
  73.  
  74.                      owner on symlinks.
  75.  
  76.      -g _g_r_o_u_p        Set the group of created files to _g_r_o_u_p, which is
  77.                      interpreted first as a group name, then as a numeric
  78.                      group ID if it fails to match known group names.  If the
  79.                      superuser invokes _i_n_s_t_a_l_l, the default group is ssssyyyyssss.
  80.                      Otherwise the default group is the effective group ID of
  81.                      the invoker.  This option is ignored if given with ----llllnnnn.
  82.                      If $$$$RRRRAAAAWWWWIIIIDDDDBBBB is set, and ----llllnnnnssss is used, it is effectively
  83.                      ignored, because _i_n_s_t(1m) does not support setting the
  84.                      group on symlinks.
  85.  
  86.      -idb _a_t_t_r_i_b_u_t_e  Add an IDB _a_t_t_r_i_b_u_t_e to the records for files which
  87.                      _i_n_s_t_a_l_l would have created in its normal mode.  This
  88.                      option may occur several times among the option
  89.                      arguments.
  90.  
  91.      -new            By default, _i_n_s_t_a_l_l creates a regular file with the same
  92.                      modification time (_m_t_i_m_e) as its source.  This option
  93.                      disables mtime preservation, resulting in each regular
  94.                      file being installed with its mtime set by _i_n_s_t_a_l_l's
  95.                      final write to it.
  96.  
  97.      -o              If a target exists, save it in the target directory with
  98.                      a hard link named OOOOLLLLDDDD_f_i_l_e .
  99.  
  100.      -O              If the target exists, try to remove it.  If it cannot be
  101.                      unlinked, save it in the same manner as ----oooo.
  102.  
  103.      -rawidb _i_d_b_p_a_t_h Change _i_n_s_t_a_l_l's mode from file creation to IDB
  104.                      generation, so that it appends records to the file named
  105.                      by _i_d_b_p_a_t_h.  This option overrides the RRRRAAAAWWWWIIIIDDDDBBBB environment
  106.                      variable.
  107.  
  108.      -root _r_o_o_t_p_a_t_h  Set the string prepended to all absolute pathnames
  109.                      created by install to _r_o_o_t_p_a_t_h.  This option overrides
  110.                      the RRRROOOOOOOOTTTT environment variable.
  111.  
  112.      -s              Be silent.  Older versions of _i_n_s_t_a_l_l printed verbose
  113.                      information by default when installing.  _I_n_s_t_a_l_l is now
  114.                      silent by default, but this option remains for
  115.                      compatibility.
  116.  
  117.      -t              Symbolically link targets to sources when installing
  118.                      regular files.
  119.  
  120.      -v              Be verbose.  This option causes _i_n_s_t_a_l_l to print a line
  121.                      telling source and target pathnames for each file
  122.                      installed.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIINNNNSSSSTTTTAAAALLLLLLLL((((1111))))                                                          IIIINNNNSSSSTTTTAAAALLLLLLLL((((1111))))
  137.  
  138.  
  139.  
  140.      Only one of the following options may be specified for a given invocation
  141.      of _i_n_s_t_a_l_l, to install non-regular files:
  142.  
  143.      -blk _m_a_j,_m_i_n[,_o_f_f]
  144.                      Create a block device node with major device number _m_a_j
  145.                      and minor number _m_i_n.  If _m_i_n has the form
  146.                      _l_o_w_m_i_n-_h_i_g_h_m_i_n, _i_n_s_t_a_l_l creates block device nodes for
  147.                      minor numbers _l_o_w_m_i_n through _h_i_g_h_m_i_n, inclusive, forming
  148.                      each node's name by concatenating _f_i_l_e and the minor
  149.                      device number.  If the optional offset is given, it is
  150.                      added to the minor number (the offset may be negative).
  151.                      This is primarily useful with the range form in scripts,
  152.                      such as ////ddddeeeevvvv////MMMMAAAAKKKKEEEEDDDDEEEEVVVV.  If the device exists, with the
  153.                      correct type (block), and correct major and minor number,
  154.                      it is left as is, and the ownership and permissions are
  155.                      left unchanged.  This also is useful in scripts where you
  156.                      want to make sure that the device exists, but want to
  157.                      preserve any local changes in owner and permissions.  The
  158.                      ----OOOO and ----oooo options are not supported with this option.
  159.  
  160.      -chr _m_a_j,_m_i_n[,_o_f_f]
  161.                      Like ----bbbbllllkkkk, but creates character device nodes.
  162.  
  163.      -c              BSD old compatibility mode (ignored)
  164.  
  165.      -dir (or -d for BSD/GNU compatibility)
  166.                      Create directories named by concatenating $$$$RRRROOOOOOOOTTTT to the
  167.                      _f_i_l_e arguments.  When -dir is given, all the _f_i_l_e
  168.                      arguments are taken as directories; files and directories
  169.                      may not both be installed with the same command.
  170.  
  171.      -fifo           Create named pipes named by the _f_i_l_e arguments.
  172.  
  173.      -ln _p_a_t_h        Create hard links named by the _f_i_l_e arguments to the node
  174.                      named by _p_a_t_h.  If _p_a_t_h is a file, it will be linked to
  175.                      _f_i_l_e.  If you want the link to be from a file in the
  176.                      directory of the -_f and -_F options you must preceed it by
  177.                      the same directory string as for those options.
  178.  
  179.      -lns _p_a_t_h       Create symbolic links named by the _f_i_l_e arguments which
  180.                      point to _p_a_t_h.  If _p_a_t_h is a relative pathname, the
  181.                      symbolic link will also be relative to the directory of
  182.                      the -_f and -_F options.
  183.  
  184.      This option may be used only when installing regular files:
  185.  
  186.      -src _p_a_t_h       Use _p_a_t_h as the source file's pathname when installing a
  187.                      regular file.  This option is useful for renaming a
  188.                      source file in the target directory.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIINNNNSSSSTTTTAAAALLLLLLLL((((1111))))                                                          IIIINNNNSSSSTTTTAAAALLLLLLLL((((1111))))
  203.  
  204.  
  205.  
  206.      One of the following two options must be used unless installing
  207.      directories with ----ddddiiiirrrr:
  208.  
  209.      -f _d_i_r          Install files in the target directory $$$${{{{RRRROOOOOOOOTTTT}}}}_d_i_r.
  210.  
  211.      -F _d_i_r          Like -_f, but creates any directories in the target
  212.                      pathname which do not exist.
  213.  
  214. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  215.      To install several programs, issue:
  216.  
  217.           install -f /etc mount umount
  218.  
  219.  
  220.      To install a file which has a different name in the target tree, and
  221.      which might be executing during installation, use:
  222.  
  223.           install -F /etc -src Install -O install
  224.  
  225.  
  226.      This invocation creates disk device nodes, along with necessary
  227.      directories:
  228.  
  229.           install -F /dev/dsk -m 600 -u root -g sys -blk 4,0-15 ips0d0s
  230.  
  231.  
  232.      BSD/GNU compatibility example:
  233.  
  234.           install -m 775 -s file1 file2 file3 /usr/gnu/bin
  235.  
  236.  
  237. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  238.      make(1).
  239.  
  240. BBBBSSSSDDDD////GGGGNNNNUUUU CCCCOOOOMMMMPPPPAAAATTTTIIIIBBBBIIIILLLLIIIITTTTYYYY NNNNOOOOTTTTEEEESSSS
  241.  
  242.      o GNU long options (e.g. --help) aren't supported.
  243.      o If strip is not installed, -s will give a warning (of course).
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.